TO: Norman Leung May 31, 1982 

Conrad Chen 

From; Peter Baum 

n I think that the document "Software Control o-f Disk II/IWM 
Controller" should also contain specific exampl es in certain 
sect i on . These ex amp 1 es shoul d be I ncl uded in the sect i on s 
where the operation requires time dependent code. The reason 
I suggest this is that the 65C02 has a few operations that 
use a different numb&r of cycles then their counterparts in 
the NMOS 6502. If the developer decides to use his own 
sequence of instructions, they may not work properly with the 
other processor. It will also make things easier in the 
future if we ever decide to use a processor that Is similar 
to the 6502, but has a few operations with different cycle 
times. A specific example would make things easier on the 
programmer. 

2> It has been brought to my attention by a developer that we 
don't follow the guidelines exactly for the write self sync 
byte operation in ProDOS. Here is what I was told: 

Last-i self sync byte 
40 < . 

Last self sync byte 
*** — > 36< 

1st address mark byte <*D5> 
32< 

2nd address mark byte <*AA) 
32< 

3rd address mark byte C*AD) 
**# — > 36< 

1st data nibble 
32 < 

2nd data n i bbl e 

1 have not checked this myself because I am not sure where 
the routines are 1 oca ted in ProDOS. The devel oper di dn'' t 
think this would affect the operation of ProDOS, but I think 
we should check into it Just to' make sure . 



3) I am also unclear from the document where the address mark 
and data mark fit In. Nowhere in the document does it tell 
when to write these bytes out, but it does mention something 
about reading them under the section titled "Read self sync". 
Specifically, shouldn't this be covered in the section on 
writing the self sync byte? Currently this section shows how 
to write the self sync bytes, followed directly by the first 
data byte. Is that correct 



Peter Baum Apple Computer May 24, 1984 
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Differences Between tiie lUlM and the Apple // Disk Controller 

The IWM (Integrated Woz Machine) is a single chip CLSI) 
implementation o-f the Disk 3E Controller state machine, 
designed and patented by Steve Ulozn iak. It is not an exact 
replica of the state machine, and though all of Apple's disk 
operating systems <DOS 3.3, ProDOS) work with it, 3rd party 
developers will find that some of their software will not 
work. This document describes all the known differences 
between the IWM, currrently used in the Apple //c , and the 
state machine used in the Apple 3E and //e di sk con trol 1 er 
card. This document only exists to describe differences and 
is not intended as a specification for the IWM or Apple // 
Di sk Control 1 er . The correct method of using the disk 
interface is described in another document, "Software Control 
of the Disk ][ or IWM Controller", which is required reading 
before perusing this document. The document is distributed to 
registered developers under the auspices of Apple // 
Developer Technical Support. (For more information contacts 
Apple Computer at above address - Certification/Registration 
Program, Mail Stop 23AF ). This document will be updated as 
more differences are uncovered. 

The Differences 

1) When reading the write protect switch only the most 
significant bit (MSB) should be tested for the status. On the 
Disk Controller other bits can be tested, but this will not 
work on the IWM. 

2) The IWM will not work properly in an Apple // if it is 
placed into a mode where both Q6H and Q7H are set and the 
motor is off (Q4L) . If the chip is placed in this mode at any 
t ime then all subsequent opera t i on s of the IWM may not work 
proper 1 y . 

3) The IWM does not require the false-read cycle, which 
occurs on indexed write instructions such as STA ^C05E,X > to 
work proper 1 y. The Di sk Control 1 er state mach i ne depends on 
the false read cycle during the STA Q7H,X instruction to 
store data properly into the shift register. This anamol y 
means that software which may work with the IWM will not work 
with the Disk Controller. This type of problem will generally 
appear if a store absolute instruction is used to set Q7H 
(STA *COEF) , since there is no false-read cycle on store 
absol ute operations. 






/' 



other Notes o-f Interest 

The IWM has never been sold in a Disk Controller card -for the 
Apple // and there are no plans to do this. All Disk 3 C 
Control 1 er Cards, sol d wi th e i ther the Di sk 3 E or the 
Duodisk, use the state machine. 

In the Apple //c the 65C02 processor, manufactured by GTE and 
NCR, is used. Some of the instructions use different cycle 
times than the corresponding instructions in the NMOS ^502 
used in the Apple //e and 3C+. If these instructions are used 
as part of the 32usec. or 40usec. loops required in the disk 
write routines, then the write routines will not work 
properly in both the Apple //e <or 3C+) and Apple //c . 

Other documents and books which may prove helpful; 

Beneath Apple DOS, by Don Worth and Pieter Lechner, from 
Quality Software 

Understanding the Apple II, by Jim Sather, from Quality 
Software 

Software Control of the IWM or Di sk 11 Control 1 er , Appl e 
Computer* 

The 6502 False-read cycles, Apple Computer* 

* — These documents are distributed to registered developers 
under the auspices of Apple // Developer Technical 
Support. <For more information contact; Apple Computer 
at above address - Certification/Registration Program, 
Mai 1 Stop 23AF ) . 
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Addendum to Softi/jare Control of the lUJH or Disk 3[ Controller 

PREFACE 

The purpose of this document is to brie-fly illustrate the 
instructions needed, to operate the disk controller. The example 
which are given show only the instruct) on s that are needed to 
operate the disk drive and the timing sequence of these 
instruct! on. An exampl e of executable code has not been given 
since the operation within the timing loops depends on other 
factors, such as the current disk function. The operations 
descr I bed i nc 1 ude : 



Selecting the Drive 



Turn i ng 


the Motor On 


Se n s ! n g 


the Wr i te Protect 


Readi ng 


a Data Byte 


Wr i t i ng 


a Data Byte 


Wr i ting 


a Sel f-Sync Byte 


Readi ng 


a Sel f-Sync Byte 


Seek i ng 


to Another Track 



Sw i t c h 



Th i s document assumes that the reader has some knowl edge of di sk 
formats and operat i ng systems. <A good pr imer for this type of 
information is the book ^Beneath Apple DOS-'), For example, this 
document doesn-'t show how to format a disk, but assumes that the 
devel oper knows how a di sk is format ted, Including the address 
marks and address field format . 



OURCE 

966 

860 

866 

366 

866 

306 

866 

800 

886 

906 

866 

000 

060 

860 

960 

806 

NEXT 

809 

!AE 41 
leo 88 
:A6 00 
iBD 8D 
iBD SF 
!A9 64 
i9D 8F 
[BD 8E 
iBD 89 
i48 
\6B 
!48 
68 
i48 
1 68 
1 48 
68 
i48 
68 
:C8 

iD0 F3 
iBD 8E 
;9D 88 
.29 IF 
iC9 04 
iD8 09 
:C8 

BD 8F 
!A9 06 
i9D 8F 
iBD 8E 
:BD 8C 



FILE fi01 =>IWi 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 

n 

12 
13 
14 
15 
16 



THIS ROUTINE WILL DETEmiNE WHETHER A STATE MACHINE DISK 13 CCKTROLLER 
OR m im CONTROLLER IS INSTALLED IN THE SYSTEM. 

UPON EXIT FROM THE ROUTINE, Y=l MEANS lUW CONTROLLER AND Y=8 MEANS 
STATE MACHINE DISK 11 CCKTROLLER. 

ASSltlE A MOTOR OFF INSTRUCTION ELDA $C088,X3 ms BEEN EXECUTED FOR 
TWO SECONDS BEFORE THE USER CALLS t^ THIS ROUTINE. OTHERWISE, A 
TWO SECOND DELAY LOOP MUST BE ADDED AFTER THE FIRST MOTOR OFF 
INSTRUCTION [LD^*C088,X3 AT THE BEGINNING OF THIS ROUTINE. 

THE ENABLED DISK DRIVE WILL CONTINUE TO BE Ol FOR 1 SEC 
AFTER EXIT FROI THIS ROUTINE. 



068 

863 

866: 

9081 

86Bi 

80Ei 

810 

813, 

016i 

819 

01Ai 

81B: 

91Ci 

81D 

01E: 

81F 

920 
821 
622 1 
823: 
624 

826: 

029; 

02C; 

02E: 

830 

632: 

833 

836 

838 

03B: 

83E; 

041 

041 



OBJECT 
1006 
16 
C0 

C0 
C0 

C0 
C0 
C0 



FILE NAME 
17 



IS 



1019 



C0 
C0 



103B 



C6 

C0 
C0 
C0 



1641 



60 



18 

19 

20 

21 

22 

23 

24 

25 

26 

27 LOOP 

28 

29 ' 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 IWM 

45 

46 

47 

48 DISKII 

49 

50 

51 



FIN 
SL0TX16 



im.0 

ORG 
LDX 
LDA 
LDY 
LDA 
LDA 
LDA 
STA 
LDA 
LDA 
PHA 
PLA 

pm 

PLA 
PHA 
PLA 
PHA 
PLA 
P^ 
PLA 
INY 
BNE 
LDA 
STA 
AND 
CMP 
BNE 
INY 
LDA 
LDA 
STA 
LDA 
LDA 
EQU 
DFB 



$1668 

SL0TX16 

$C688,X 

1106 

*C68D,X 

*C68F,X 

**$84 

*C68F,X 

$C68E,X 

$C889,X 



LOOP 

*C98E,X 

$C888,X 

ft$lF 

tf$64 

DISKII 

$C08F,X 

«$80 

$C68F,X 

*C68E,X 

$C08C,X 

* 

$68 



jX REG=SLOT NO. X 16 

jMOTOR OFF 

; CLEAR REG. Y 

;Q6H 

;Q7H, ADDRESS MODE REG. 

jDISABLE TIMER BIT IN MODE REG. 
;Q7L, OUT OF WRITE MODE 
jMOTOR m 

I 10 MSEC DELAY LOOP 

jWAIT FOR THE MOTOR CN 

'j SIGNAL TO BE ACTIVE IN 

jTHE CONTROLLER CARD 



J END OF DELAY LOOP 

jQ7L, READ STATUS REG. 

JMOTOR OFF 

jMASK 5 L.S. BITS 

iCHECK TIMER BIT 

jDISK 11 CONTROLLER IF NOT 

; INCREMENT Y REG. 
jQ7H, ADDRESS MODE REG. 



EQ 



iQ7H, 
jQ7L, 
;Q6L, 



RESTORE MODE REG. 



RESTORE TO READ MODE 



i'83B^DISKII ?184l FIN ?1932 im 1919 LOOP 

1841 SL0TX14 

* SUCCESSFUL ASSEMBLY := NO ERRORS 

* ASSEMBLER CREATED ON 15-J^-84 21i28 

* TOTAL" LINES ASSEMBLED 51 

* FREE SPACE PAGE COl^TT 89 



